home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu086.dms / pu086.adf / CONTENTS < prev    next >
Text File  |  1990-12-04  |  5KB  |  188 lines
  1. (c) 1990 S.Hawtin.
  2.  
  3.   NorthC 1.3 provides an selection of programs, documentation and 
  4. examples, if your version does not contain all the following you should 
  5. complain to the person you got it from.
  6.  
  7.   This release has been spread across two disks, this gives me enough space 
  8. to include a larger set of examples.  The "NorthC:" disk contains the 
  9. essential programs, the "NorthC Examples:" disk contains some examples and 
  10. some of the source code for the programs.
  11.  
  12.  
  13. "NorthC:" disk
  14.  
  15.  
  16. setup-NorthC  Single-make  Dual-Disk  Hard-Disk
  17.  
  18.   These script files set up the NorthC environment, you should edit the 
  19. "setup-NorthC" file to call the setup file that is needed for your system.
  20.  
  21.  
  22. README
  23.  
  24.   A quick introduction to the astounding bonuses of using one of the best 
  25. value for money 'C' compilers on the Amiga.
  26.  
  27.  
  28. CONTENTS
  29.  
  30.   A list of the contents of the "NorthC:" disk, this file in fact.
  31.  
  32.  
  33. CHANGES
  34.  
  35.   This file lists the changes that have been made to NorthC in each release, 
  36. it will be of most use if you are updating an old NorthC disk.
  37.  
  38.  
  39. CONTRIBUTORS
  40.  
  41.   This file lists some of the many people that have helped make NorthC 
  42. possible.
  43.  
  44.  
  45. tools
  46.  
  47.   The source files for the "ar" and "cc" programs, the command "make" will 
  48. recompile these files for you.  These are here mainly as examples that are 
  49. garenteed to compile with NorthC.  Also cc.c is a good program to hack 
  50. about a bit if you want to change your top level interface.
  51.  
  52.  
  53. clibs
  54.  
  55.   The 'C' library files, this directory contains the files NorthC requires
  56. for the standard library and the startup routines.  These files include 
  57. documentation of the 'C' library, source for the startup routines and the 
  58. 'C' library itself.
  59.  
  60.  
  61. bin
  62.  
  63.   This directory contains the actual tools, the compiler, assembler, linker, 
  64. optimiser, make program and front end for NorthC, these mostly come from 
  65. other people see the documentation for the originators.
  66.  
  67.  
  68. bin/NorthC  bin/NorthC.doc
  69.  
  70.   The compiler, this will translate 'C' source into assembler files.  
  71. Read the file "bugs.doc" to find details of the current release.
  72.  
  73.  
  74. bin/a68k  bin/A68k.doc
  75.  
  76.   The assembler from Charlie Gibbs, again the doc file gives more details.
  77. This translates assembler files into object files.
  78.  
  79.  
  80. bin/Blink   bin/Blink.doc
  81.  
  82.   The linker from "The Software Distillary", see the doc file for details.
  83. This combines object files and libraries to produce executable programs.
  84.  
  85.  
  86. bin/Bugs.doc
  87.  
  88.   A list of known bugs in this version of NorthC, this includes work 
  89. arounds for many of the bugs.  It is important to read this document when 
  90. you find your program not behaving as it should.
  91.  
  92.  
  93. bin/make bin/make.doc
  94.  
  95.   The make program, I have supported the basic elements of "make" but some 
  96. elements, such as variables, are missing.
  97.  
  98.  
  99. bin/cc  bin/cc.doc
  100.  
  101.   The front end, this will control the compiler assembler and linker.  This
  102. program loosly follows the normal UNIX conventions, however it needs to be
  103. hacked before it does everything you will need.
  104.  
  105.  
  106. bin/ar
  107.  
  108.   The library creator, note this takes a very simple view of creating 
  109. libraries, it just concatenates files together.  See the tools directory
  110. to examine the source.
  111.  
  112.  
  113. bin/top  bin/top.doc
  114.  
  115.   The optimiser, this program will make assembler code more efficient.
  116.  
  117.  
  118. include
  119.  
  120.   This directory contains the "include" files, the compiler automatically 
  121. looks in the ":include" directory for the include files, if you want it to 
  122. look elsewhere change the "INCLUDE" environment variable.  All the standard 
  123. header files are in this directory.
  124.  
  125.  
  126. Texts
  127.  
  128.   This directory contains various texts that I thought people would be 
  129. interested in reading.
  130.  
  131.  
  132. "NorthC Examples:" disk
  133.  
  134.  
  135. clibs/UNIX
  136.  
  137.   This directory contains an example 'C' library, this one implements some 
  138. UNIX like file handling routines.
  139.  
  140.  
  141. CRender
  142.  
  143.   This directory contains an example program, this program draws three 
  144. dimensional solid models, it also calls intuition and some graphics 
  145. routines.
  146.  
  147.  
  148. disass
  149.  
  150.   This directory contains a program that disassembles object modules, 
  151. the hard bit was written by Martin Combs, I have just added some code 
  152. to take account of Amiga object formats.
  153.  
  154.  
  155. fortune
  156.  
  157.   A simple "fortune" type program, this prints out sayings from a file 
  158. in the directory and uses the narrator device to say them.
  159.  
  160.  
  161. hello
  162.  
  163.   This is a bare directory to create the "hello.c" program in, it contains 
  164. a file "hello.doc" that explains how to create a simple 'C' program.
  165.  
  166.  
  167. iff
  168.  
  169.   This directory contains an IFF reader, from Electronic Arts.  The only 
  170. program I have got working is one that displays IFF pictures.
  171.  
  172.  
  173. top  make
  174.  
  175.   The source code for some of the tools in the "NorthC:bin" directory.
  176.  
  177.  
  178. mini-hello
  179.  
  180.   This directory shows how you can reduce the size of 'C' programs 
  181. by manipulating the startup routines in your NorthC programs.
  182.  
  183.  
  184. split
  185.  
  186.   This simple program splits a large file into a number of smaller ones.
  187.  
  188.